home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / DISK / FIND221.ARJ / FIND.DOC next >
Text File  |  1991-10-15  |  48KB  |  1,717 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.          Online Reference Software
  8.           
  9.           
  10.          Assembly language software products
  11.          providing maximum performance in a
  12.          minimum amount of space.
  13.           
  14.           
  15.          FIND - fastest file and zip search for DOS
  16.           
  17.           
  18.           
  19.           
  20.           
  21.           
  22.           
  23.           
  24.           
  25.           
  26.           
  27.                         Users Manual - October 15, 1991
  28.           
  29.           
  30.           
  31.           
  32.           
  33.           
  34.           
  35.           
  36.           
  37.           
  38.           
  39.           
  40.           
  41.           
  42.           
  43.           
  44.           
  45.           
  46.           
  47.           
  48.           
  49.           
  50.           
  51.           
  52.           
  53.           
  54.           
  55.           
  56.           
  57.           
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                     Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                LICENSE STATEMENT
  74.           
  75.           
  76.           
  77.          Online Reference hereby grants you, the user, a non-exclusive
  78.          license to use FIND in its delivered form.
  79.           
  80.          You may use the registered version of the software on any
  81.          computer, provided that the software can in no way be used on
  82.          more than one computer at the same time.
  83.           
  84.          You are encouraged to freely copy and distribute the share
  85.          ware version of the software as long as it is not modified or
  86.          missing any of the component files.
  87.           
  88.           
  89.           
  90.           
  91.           
  92.                                    WARRANTY
  93.           
  94.           
  95.           
  96.          Online Reference warrants software delivered by diskette to
  97.          be an accurate copy of the master diskette.  Defective
  98.          diskettes will be replaced free of charge within 60 days
  99.          after purchase.
  100.           
  101.          Online Reference explicitly disclaims all other warranties
  102.          whether expressed or implied, including, without limitation,
  103.          the implied warranties of merchantability and fitness for any
  104.          particular purpose.  Online Reference shall have no liability
  105.          for consequential, incidental, exemplary or special damages,
  106.          including lost profits.
  107.           
  108.          Online Reference reserves the right to improve or change the
  109.          product at any time without prior notice.
  110.           
  111.           
  112.           
  113.           
  114.           
  115.                                TECHNICAL SUPPORT
  116.           
  117.           
  118.           
  119.          Completing the registration form and paying the published
  120.          fees for the software, qualifies the owner for technical
  121.          support.
  122.           
  123.           
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                     Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.          CONTENTS
  140.           
  141.           
  142.          INTRODUCTION.............................................. 5
  143.              Overview.............................................. 5
  144.              File contents......................................... 5
  145.              Enhancements.......................................... 5
  146.           
  147.           
  148.          FEATURES OVERVIEW......................................... 6
  149.              Standard Features summary............................. 6
  150.              Advanced Features summary............................. 6
  151.           
  152.           
  153.          FINDINST.................................................. 7
  154.              Overview.............................................. 7
  155.              Colors................................................ 8
  156.              Drive Search Range.................................... 9
  157.              Command Line Switches.................................10
  158.              CGA Snow Checking.....................................10
  159.           
  160.          STANDARD FEATURES
  161.              Performance...........................................11
  162.              DOS Wildcards.........................................12
  163.              Elapsed Time..........................................12
  164.              DOS Directory Format..................................13
  165.              Intelligent I/O.......................................13
  166.              Long Screen Support...................................13
  167.              Dynamic Memory Allocation.............................14
  168.              EMS Memory............................................14
  169.              Extended Disk Partitions..............................15
  170.              Multi-Drive Search....................................15
  171.              SNAPSHOT Disk Dump....................................15
  172.           
  173.           
  174.          ADVANCED FEATURES
  175.              Fuzzy Search..........................................16
  176.              Command Line Switches.................................17
  177.                  /G - Goto first match.............................17
  178.                  /H - Hidden Search................................17
  179.                  /L - List Buffer..................................17
  180.                  /P - Pause Full Screen............................18
  181.                  /S - Single Drive.................................18
  182.                  /V - Verbose Path.................................18
  183.                  /Z - ZIP Search...................................18
  184.           
  185.           
  186.           
  187.           
  188.           
  189.           
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                     Page 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.          CONTENTS
  206.           
  207.           
  208.          IMPLEMENTATION
  209.              Technical Data........................................19
  210.              PIF...................................................20
  211.              DOS Error Level.......................................20
  212.              CGA Snow Checking.....................................20
  213.              Error Messages........................................21
  214.              Switch Summary........................................22
  215.              Command Line Examples.................................23
  216.              SUBST drives..........................................25
  217.              Networks..............................................25
  218.              DesqView..............................................25
  219.           
  220.           
  221.          SUPPORT
  222.              Bug Reports...........................................26
  223.              BBS System............................................26
  224.           
  225.           
  226.           
  227.           
  228.           
  229.           
  230.           
  231.           
  232.           
  233.           
  234.           
  235.           
  236.           
  237.           
  238.           
  239.           
  240.           
  241.           
  242.           
  243.           
  244.           
  245.           
  246.           
  247.           
  248.           
  249.           
  250.           
  251.           
  252.           
  253.           
  254.           
  255.           
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                     Page 4
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.          INTRODUCTION
  272.           
  273.           
  274.          FIND is an ultra high speed file finding program.
  275.           
  276.          It searches the disk drive(s) for the specified files using
  277.          the standard DOS drive, file name and wild card structure.
  278.          The registered version will optionally search ZIP (tm) files.
  279.           
  280.           
  281.          The unregistered version contains the following files:
  282.           
  283.              o   README       - Shareware distribution instructions
  284.              o   README.PRN   - Document printing instructions
  285.              o   FIND.DOC     - This file
  286.              o   FIND.EXE     - Uses intelligent output display
  287.              o   FIND.HST     - History file FIND versions
  288.              o   FIND.HDR     - CompuServe file description header
  289.              o   FIND.KEY     - CompuServe file description keywords
  290.              o   FINDINST.EXE - Installation and customization program
  291.              o   SNAPSHOT.EXE - Capture disk sectors for bug reports
  292.              o   ORDER.FRM    - Ordering and registration form
  293.           
  294.           
  295.           
  296.              FIND is not public domain nor free software.
  297.              The unregistered version is a full speed, complete file
  298.              finder.  Its capacity and performance have not been
  299.              degraded in any way.
  300.           
  301.           
  302.           
  303.          Enhancements:
  304.           
  305.              o  ZIP file search
  306.              o  Fuzzy name search
  307.              o  Installation program
  308.              o  Speed
  309.              o  Color
  310.              o  Single or Multiple drive search
  311.              o  Elapsed time
  312.              o  Exclusive hidden file search
  313.              o  Standard DOS display format
  314.              o  Intelligent output display
  315.              o  Support 80x43 and 132x43 screen sizes
  316.              o  EMS memory used when available
  317.              o  DOS 5 extended disk partition support
  318.              o  Dynamic data segment allocation
  319.              o  Debugging aid
  320.              o  DesqView aware
  321.           
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                     Page 5
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.          FEATURES
  338.           
  339.           
  340.          Standard features:
  341.           
  342.              o  Install program
  343.              o  Speed
  344.              o  Automatic search of multiple drives
  345.              o  Automatic wild card names
  346.              o  Colors
  347.              o  Elapsed Time
  348.              o  Display uses DOS directory format
  349.              o  Intelligent I/O
  350.              o  Long screen support
  351.              o  Dynamic memory allocation
  352.              o  EMS memory support
  353.              o  Extended disk partitions
  354.              o  SNAPSHOT debugging aid
  355.              o  DesqView aware
  356.           
  357.           
  358.           
  359.          Registered features:
  360.           
  361.              o  Fuzzy search for embedded name characters
  362.              o  Search single drive only
  363.              o  Hidden-only file search
  364.              o  Pause when screen is full
  365.              o  Verbose path display
  366.              o  Goto first match
  367.              o  Scroll buffer
  368.              o  CGA snow check control
  369.              o  ZIP file search
  370.           
  371.           
  372.           
  373.           
  374.           
  375.           
  376.           
  377.           
  378.           
  379.           
  380.           
  381.           
  382.           
  383.           
  384.           
  385.           
  386.           
  387.           
  388.  
  389.  
  390.  
  391.  
  392.  
  393.                                     Page 6
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.          INSTALLATION
  404.           
  405.           
  406.          --------
  407.          OVERVIEW
  408.          --------
  409.          FIND incorporates an installation program named FINDINST that
  410.          will customize FIND for user-specified colors and options.
  411.           
  412.          FINDINST is version sensitive, and will complain if the
  413.          version is incorrect.  Unregistered and Registered versions
  414.          of the software are unique and cannot be mixed.
  415.           
  416.          The installation program expects to locate FIND.EXE
  417.          in the default directory.  The file name must be unchanged
  418.          from the distribution disk to install properly.
  419.           
  420.          Once installed, FIND may be freely renamed.
  421.           
  422.           
  423.           
  424.           
  425.           
  426.           
  427.           
  428.           
  429.           
  430.           
  431.           
  432.           
  433.           
  434.           
  435.           
  436.           
  437.           
  438.           
  439.           
  440.           
  441.           
  442.           
  443.           
  444.           
  445.           
  446.           
  447.           
  448.           
  449.           
  450.           
  451.           
  452.           
  453.           
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                     Page 7
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.          INSTALLATION
  470.           
  471.           
  472.          ------
  473.          COLORS
  474.          ------
  475.          The user may configure the text and inverse video colors used
  476.          by FIND during operation.  The banner colors are fixed and
  477.          cannot be changed.  The default value is to accept whatever
  478.          colors are found at the cursor location when FIND loads.
  479.           
  480.          Invoke FINDINST and choose the Customize Colors option from
  481.          the main menu.
  482.           
  483.          The Normal Text and Inverse Video data are displayed
  484.          in the colors currently installed in FIND.
  485.           
  486.          The un-installed version of FIND defaults to whatever colors
  487.          are present at the cursor when the program is invoked.
  488.          FINDINST provides an option on the Colors Menu to restore
  489.          the defaults.
  490.           
  491.          FINDINST displays the default colors in black and white until
  492.          they are changed.  The demo strings are displayed in the new
  493.          color after each selection.  The colors are not installed in
  494.          FIND until the user exits FINDINST.
  495.           
  496.          The user is prompted to enter the hexadecimal values for
  497.          the text or inverse video option.  The number is always
  498.          entered as a 2 digit number.  Results are unpredictable
  499.          if a single digit is entered.
  500.           
  501.          The left number is the Background color.
  502.          The right number is the Foreground color.
  503.           
  504.          07 = White text on black
  505.          17 = White text on blue
  506.          70 = Black text on white (inverse)
  507.           
  508.          The user may enter any value up to FF, if the blink is
  509.          desired.  The color banners are fixed colors, and may not
  510.          be changed by the user.
  511.           
  512.          TEXT colors are for the file name matches displayed when FIND
  513.          executes.  A file that matches the input argument will be
  514.          displayed as a TEXT color, even if it is a ZIP file.
  515.           
  516.          INVERSE colors are for the subdirectory names and/or ZIP file
  517.          names that are displayed.  A ZIP file holding a member file
  518.          that matches the input argument is displayed in INVERSE
  519.          color.  The member will be displayed in TEXT color.
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                     Page 8
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.          INSTALLATION
  536.           
  537.           
  538.          -----------
  539.          DRIVE RANGE
  540.          -----------
  541.          The user may configure FIND to stop searching after a
  542.          specified drive letter.  This will be useful to those who
  543.          have a network drive and don't wish to search all logical
  544.          drives.
  545.           
  546.          Floppy drives that have been ASSIGNED to a higher letter may
  547.          also be bypassed using this configuration option.  The
  548.          default is for drive 'Z'.
  549.           
  550.          Invoke FINDINST and choose the Drive Search Range option
  551.          from the main menu.
  552.           
  553.          The current highest drive will display as a drive letter.
  554.          The default value in FIND is 'Z'.   The default value for
  555.          the starting drive is the first hard drive.
  556.           
  557.          FIND begins its search with the first hard drive, unless
  558.          the command line file name contains a drive letter or the
  559.          first starting drive is set with FINDINST.
  560.           
  561.          In either case, the search will automatically increment the
  562.          drive number until no more drives are left to search.  Any
  563.          drive that appears as a valid DOS disk will be searched.
  564.           
  565.          If the user has ASSIGNED a floppy drive as a different drive
  566.          with a letter higher than the last hard disk, it too will be
  567.          searched.  FIND will pause for a moment if the floppy is
  568.          empty, and then quit.  Installing the highest search drive
  569.          option will stop FIND from searching assigned drives.
  570.           
  571.          Another use is on a very large drive, that goes from C to W
  572.          or even higher.  In spite of FIND's tremendous speed, it will
  573.          still slow down on a very large drive, particularly so, if
  574.          that drive contains many ZIP files.
  575.          The user can limit the search range by using the
  576.          Highest Search option.
  577.           
  578.           
  579.           
  580.           
  581.           
  582.           
  583.           
  584.           
  585.           
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                     Page 9
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.          INSTALLATION
  602.           
  603.           
  604.          --------
  605.          SWITCHES
  606.          --------
  607.          The user may configure FIND for any of the command line
  608.          switches.  These switches are actually toggles, and may
  609.          be overridden on the command line.
  610.           
  611.          If the /Z switch is set by FINDINST, using it on the command
  612.          line will toggle it to OFF for a one-time run of FIND.
  613.           
  614.           
  615.           
  616.          -----------------
  617.          CGA SNOW CHECKING
  618.          -----------------
  619.          FINDINST is invoked without a command line name.  An optional
  620.          command line argument [/OFF] will bypass CGA snow checking
  621.          for machines that have problems with it, or don't need it.
  622.           
  623.          e.g.  FINDINST /OFF
  624.           
  625.          This switch will force FINDINST to run with snow checking
  626.          disabled.  The user may install this option into FIND by
  627.          selecting the SWITCHES entry on the first menu.
  628.           
  629.           
  630.           
  631.           
  632.           
  633.           
  634.           
  635.           
  636.           
  637.           
  638.           
  639.           
  640.           
  641.           
  642.           
  643.           
  644.           
  645.           
  646.           
  647.           
  648.           
  649.           
  650.           
  651.           
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                     Page 10
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.          STANDARD FEATURES
  668.           
  669.           
  670.          -----------
  671.          PERFORMANCE
  672.          -----------
  673.          FIND is significantly faster than other file finders.
  674.           
  675.          The following times were derived from the OLR BBS server.
  676.          Files=32, Buffers=25, No cache, Defragged disk.
  677.           
  678.                                 827 - normal files
  679.                                 712 - zip files
  680.                                7259 - zip members
  681.           
  682.                                   16 Mhz 80286
  683.                                     82mb C:
  684.                                     DOS 5.0
  685.           
  686.                           ┌──────────┬──────┬───────┐
  687.          ZIP              │ FIND221  │  :39 │ 1107% │
  688.          Search           ├──────────┼──────┼───────┤
  689.                           │ PKFIND10 │ 7:12 │  100% │
  690.                           ├──────────┼──────┼───────┤
  691.                           │ SST 53a  │ 7:12 │  100% │
  692.                           └──────────┴──────┴───────┘
  693.           
  694.           
  695.                           ┌──────────┬──────┬───────┐
  696.          Normal           │ FIND221  │ 1.65 │  276% │
  697.          Search           ├──────────┼──────┼───────┤
  698.                           │ PKFIND10 │ 4.56 │  100% │
  699.                           ├──────────┼──────┼───────┤
  700.                           │ SST 53a  │ 5.47 │   83% │
  701.                           └──────────┴──────┴───────┘
  702.           
  703.           
  704.          Other file finders were tested but not included.
  705.          They were unable to read the ZIP files or crashed under
  706.          the large disk partition.
  707.           
  708.           
  709.           
  710.           
  711.           
  712.           
  713.           
  714.           
  715.           
  716.           
  717.           
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                     Page 11
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.          STANDARD FEATURES
  734.           
  735.           
  736.          -----------------------
  737.          DOS Automatic Wildcards
  738.          -----------------------
  739.          FIND uses the DOS wildcard system for command line arguments.
  740.           
  741.          FILENAME.      = FILENAME.
  742.          FILENAME       = FILENAME.???
  743.          FILE           = FILE????.???
  744.          FILE.          = FILE    .???
  745.          .EXE           = ????????.EXE
  746.           
  747.          *123.*45       = ????????.???
  748.          .              = ????????.
  749.          .*             = ????????.???
  750.          *.*            = ????????.???
  751.          *              = ????????.???
  752.           
  753.          *.             = ????????.
  754.          *.X*           = ????????.X??
  755.           
  756.           
  757.           
  758.          ------------
  759.          Elapsed Time
  760.          ------------
  761.          FIND displays the total amount of time required to search
  762.          all drive(s).
  763.           
  764.          Totals are displayed for number of files matching the input
  765.          argument, total number of files, and number of directories.
  766.           
  767.           
  768.           
  769.           
  770.           
  771.           
  772.           
  773.           
  774.           
  775.           
  776.           
  777.           
  778.           
  779.           
  780.           
  781.           
  782.           
  783.           
  784.  
  785.  
  786.  
  787.  
  788.  
  789.                                     Page 12
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.          STANDARD FEATURES
  800.           
  801.           
  802.          --------------------
  803.          DOS Directory Format
  804.          --------------------
  805.          FIND displays all file data in the DOS directory format.
  806.          All file data exactly matches the DOS location and format
  807.          conventions.
  808.           
  809.          The file attributes are appended to the standard DOS display
  810.          as both a hex number and their associated name(s).
  811.           
  812.           
  813.           
  814.          --------------------------
  815.          Intelligent output display
  816.          --------------------------
  817.          FIND determines if DOS I/O redirection to a disk file or
  818.          printer is active.
  819.           
  820.          When redirection is active, all output is displayed a second
  821.          time using DOS.  All screen output except the author banners
  822.          are then output to the redirected device or file.
  823.           
  824.          For the screen, the color attribute found at the starting
  825.          cursor location is used.
  826.           
  827.          FIND automatically uses whichever video page number is active
  828.          at startup.  The user video configuration remains unchanged.
  829.           
  830.           
  831.           
  832.          -------------------
  833.          Long screen support
  834.          -------------------
  835.          FIND uses the screen mode that is active at startup.
  836.          The 80x43 and 132x43 text screens are supported.
  837.          40 column mode is not supported.
  838.           
  839.           
  840.           
  841.           
  842.           
  843.           
  844.           
  845.           
  846.           
  847.           
  848.           
  849.           
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                     Page 13
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.  
  864.  
  865.          STANDARD FEATURES
  866.           
  867.           
  868.          -------------------------
  869.          Dynamic Memory Allocation
  870.          -------------------------
  871.          Internal data segment sizes are allocated on the fly for each
  872.          logical drive that is searched.  Memory is allocated in the
  873.          exact amount required for each drive.
  874.           
  875.          Assume no EMS memory, extended disk partitions and options
  876.          enabled for a worst-case memory map:
  877.           
  878.                           ■   13k code and stack space
  879.                           ■  128k FAT table
  880.                           ■   64k path table
  881.                           ■   64k scroll buffer
  882.                           ■   64k minimum directory data
  883.                           ■   16k floating zip segment
  884.                               -------------------------
  885.                               349k memory requirements
  886.           
  887.           
  888.           
  889.          ------------------
  890.          EMS memory support
  891.          ------------------
  892.          FIND will utilize up to 12 pages of EMS memory for the path
  893.          table and scroll buffer.  This increases the directory data
  894.          space by 132k, and reduces a potential out-of-memory error
  895.          when searching large subdirectories.
  896.           
  897.          FIND identifies the EMMXXXX0 device drive signature then
  898.          allocates EMS memory via DOS interrupt 67h with LIM 3.2
  899.          or higher.  The current context mapping is saved at entry
  900.          and is then restored when FIND terminates.
  901.           
  902.          FIND currently supports 512 directories, and an unlimited
  903.          amount of files.
  904.           
  905.          FIND can execute as a child process of a parent that uses
  906.          EMS memory without interfering with the parents' data.
  907.           
  908.           
  909.           
  910.           
  911.           
  912.           
  913.           
  914.           
  915.           
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                     Page 14
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.  
  930.  
  931.          STANDARD FEATURES
  932.           
  933.           
  934.          -------------------------------
  935.          Extended disk partition support
  936.          -------------------------------
  937.          FIND supports DOS disk partitions greater than 32mb.
  938.           
  939.          Note that FIND will not work on some non-DOS partitions.  A
  940.          valid DOS boot sector is required on each drive that is
  941.          searched.
  942.           
  943.          Use the DOS FDISK command to DISPLAY the partiton table
  944.          information when a non-DOS partition is suspected.
  945.           
  946.           
  947.           
  948.          ---------------------
  949.          Multiple Drive Search
  950.          ---------------------
  951.          FIND will search multiple drives in ascending order starting
  952.          with the drive specified by the user.  If none is specified
  953.          then the first hard disk is assumed.
  954.           
  955.          Note that systems without a hard drive or ram disk must
  956.          ALWAYS specify the drive letter.  FIND defaults to the first
  957.          drive after the last installed floppy disk.
  958.           
  959.           
  960.           
  961.          ------------------
  962.          SNAPSHOT Disk Dump
  963.          ------------------
  964.          SNAPSHOT.EXE is a debug aid that captures the first 317k of
  965.          data on the specified disk.  The captured data is then
  966.          written to a floppy disk in drive A: as SNAPSHOT.DAT.
  967.           
  968.          When I receive this disk and data, I can reassemble FIND in
  969.          debugging mode and run on the image of your disk.
  970.           
  971.          Caveats:  ALL user data within the 1st 317k of the disk will
  972.          be captured.  When I receive the SNAPSHOT dump, the user
  973.          agrees to release me from all liability associated with his
  974.          data.
  975.           
  976.           
  977.           
  978.           
  979.           
  980.           
  981.           
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                     Page 15
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.          ADVANCED FEATURES
  998.           
  999.           
  1000.          ------------
  1001.          Fuzzy Search
  1002.          -------------
  1003.          FIND will support the following command line arguments for
  1004.          embedded characters.
  1005.           
  1006.          Bracketing a string of characters with '*' tells the
  1007.          parser to match that sequence of characters anywhere in
  1008.          the file name and/or extension.
  1009.           
  1010.          Rules:
  1011.          (1)  A fuzzy search field must begin with the asterisk (*)
  1012.               in the first position of the name or file extension.
  1013.           
  1014.          (2)  At least one valid DOS character must be between the two
  1015.               asterisk brackets.  The '?' wildcard is valid.
  1016.               Two consecutive asterisk will return an error.
  1017.           
  1018.          (3)  The fuzzy character count can be no more than 8 for the
  1019.               name field, or 3 for the extension field.
  1020.               This count does not include the brackets (*).
  1021.               An overlength name or extension returns an error.
  1022.           
  1023.          A full length field of fuzzy bytes will be interpreted as
  1024.          a non-fuzzy search, and no error will be returned.
  1025.           
  1026.           
  1027.          IB*AB*         = IB??????    .???
  1028.          *IB*.COM       = <<IB>>      .COM
  1029.          *IB*           = <<IB>>      .???
  1030.          *IB*.i*        = <<IB>>      .i??
  1031.          *IB*.*i*       = <<IB>>      . <<i>>
  1032.          *I?M*.COM      = <<I?M>>     .COM
  1033.          *1234567*.*12* = <<1234567>> . <<12>>
  1034.           
  1035.          *12345678*     = 12345678    .???        ; Legal but useless
  1036.          LOTUS.*123*    = LOTUS       .123        ; Legal but useless
  1037.           
  1038.          *123456789*    = ERROR       ; Overlength name
  1039.          **.Exe         = ERROR       ; Double splats together
  1040.          LOTUS.*1234*   = ERROR       ; Overlength extent
  1041.          *A*B*C.EXE     = ERROR       ; More than 2 '*' wildcards
  1042.           
  1043.           
  1044.           
  1045.           
  1046.           
  1047.           
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                     Page 16
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.          COMMAND LINE SWITCHES
  1064.           
  1065.           
  1066.          Switches are available in the Registered version only.
  1067.           
  1068.          Invoke FINDINST and choose the Command Line Switches option.
  1069.           
  1070.          All the currently supported command line switch states will
  1071.          be displayed.  The user is provided with a menu to
  1072.          individually set a switch, or to clear all switches.
  1073.           
  1074.           
  1075.           
  1076.          ---------------------
  1077.          /G - Goto First Match
  1078.          ---------------------
  1079.          When set, FIND will display the drive, path, and file name
  1080.          of the first file that matches the input argument.
  1081.          The default drive and path will be set to that of the matched
  1082.          file, and the program will terminate.
  1083.           
  1084.           
  1085.           
  1086.          ----------------------
  1087.          /H - Hidden Files Only
  1088.          ----------------------
  1089.          When set, FIND will search all drive(s) and display only
  1090.          those files which have the SYSTEM or HIDDEN bits set in
  1091.          their directory entry.
  1092.           
  1093.          This search will pick up the DOS system files, and all
  1094.          volume labels.  Any other hidden files, such as those
  1095.          installed by copy protection programs will also be displayed.
  1096.           
  1097.          Subdirectories marked as hidden are not displayed.
  1098.           
  1099.           
  1100.           
  1101.          -----------------------
  1102.          /L - List Scroll Buffer
  1103.          -----------------------
  1104.          When set, FIND will keep an internal scroll buffer capable
  1105.          of displaying the first 64k of output.  When FIND has
  1106.          completed it search, the user may use the cursor keys to
  1107.          scroll up and down in the buffer.
  1108.           
  1109.          The scroll buffer can display at least 819 lines of output
  1110.          without having to redirect the output to a disk file.
  1111.          Larger requirements dictate the use of a disk redirection
  1112.          file.  Screen output is turned off when /L is active.
  1113.          I/O redirection cancels the scroll buffer.
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.                                     Page 17
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.  
  1129.          COMMAND LINE SWITCHES
  1130.           
  1131.           
  1132.          Switches are available in the Registered version.
  1133.           
  1134.          --------------------------
  1135.          /P - Pause for Full Screen
  1136.          --------------------------
  1137.          When set, FIND will pause when the screen is full and prompt
  1138.          the user to hit any key to continue.  The top screen banner
  1139.          will scroll off leaving all of the following screens at full
  1140.          length for output display.  Each subsequent screen will also
  1141.          pause when full.
  1142.           
  1143.          The /L option will disable the pause switch.
  1144.           
  1145.           
  1146.           
  1147.          ------------------------
  1148.          /S - Single drive search
  1149.          ------------------------
  1150.          When set, FIND will only search a single drive.
  1151.          If no drive letter is given with the command line argument
  1152.          the default drive is searched.
  1153.           
  1154.          A drive letter given in the command line will cause FIND to
  1155.          begin the search at that drive, and stop when the specified
  1156.          drive is complete.
  1157.           
  1158.           
  1159.           
  1160.          -------------------------
  1161.          /V - Verbose path display
  1162.          -------------------------
  1163.          When set, FIND will display all subdirectories searched.
  1164.          This is useful for building a list of all subdirectories
  1165.          on all drive(s) searched.
  1166.           
  1167.          This switch is also used if FIND is suspected of not finding
  1168.          a subdirectory.  Junk is an indicator of a bug in FIND or
  1169.          other disorder such as a cross-linked subdirectory.
  1170.           
  1171.           
  1172.           
  1173.          --------------------
  1174.          /Z - ZIP file search
  1175.          --------------------
  1176.          When set, FIND will open and search all ZIP files.
  1177.          Any ZIP member that matches the input argument will be
  1178.          displayed.  The ZIP file holding that member will be
  1179.          displayed in Inverse video, as a subdirectory would be.
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                                     Page 18
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.  
  1194.  
  1195.          IMPLEMENTATION
  1196.           
  1197.           
  1198.          --------------
  1199.          Technical Data
  1200.          --------------
  1201.          Screen performance has been improved by utilizing direct
  1202.          screen writes.  Snow prevention is implemented only when
  1203.          the CGA card is detected.  Snow checking is disabled when
  1204.          DesqView is active.
  1205.           
  1206.          FIND uses IOCTL function 4408h to check each drive to
  1207.          determine if it is removeable or fixed media.  Removeable
  1208.          media drives are read with BIOS, and fixed drives are read
  1209.          with DOS.  This bypasses the DOS error message that is
  1210.          generated when the drive door is open.
  1211.           
  1212.          FIND uses the DOS direct read interrupt Int25h.
  1213.          DOS 4 and higher versions deviate from earlier versions in
  1214.          the manner that this interrupt is implemented.  FIND
  1215.          automatically uses the extended partition calling convention
  1216.          for DOS 4 and up.  FIND operates correctly under MS-DOS 5.0
  1217.          and the extended size disk partitions it supports.
  1218.           
  1219.          FIND takes over one interrupt vector, Int23h (Control Break).
  1220.          The control break allows the user to quit FIND at any
  1221.          point during the execution.
  1222.           
  1223.          The vector is restored upon any exit from the program.
  1224.           
  1225.          A user entered ^C causes the program to terminate and
  1226.          restore the ^C vector at exit.
  1227.           
  1228.          FIND performs direct reads of the disk and can not damage the
  1229.          integrity of the disk.  No writes are done to the disk.
  1230.           
  1231.          There exists a naming conflict with a DOS program of the same
  1232.          name.  FIND can be renamed to something else if the DOS
  1233.          program is regularly used.  FIND can also be placed in a
  1234.          path that comes before the DOS path.  One suggested method
  1235.          of avoiding the naming conflict is to rename the DOS function
  1236.          as FIND!.EXE.
  1237.           
  1238.          FIND is written entirely in Turbo Assembler v2.5.
  1239.           
  1240.           
  1241.           
  1242.           
  1243.           
  1244.           
  1245.           
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.                                     Page 19
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.          IMPLEMENTATION
  1262.           
  1263.           
  1264.          ---
  1265.          PIF
  1266.          ---
  1267.          FIND is 'ill behaved' in screen management functions
  1268.          as direct screen writes are used.
  1269.           
  1270.          FIND is 'ill behaved' for vectors as it takes over Int 23h,
  1271.          the Control-Break vector.
  1272.           
  1273.           
  1274.           
  1275.          --------------
  1276.          DOS ERRORLEVEL
  1277.          --------------
  1278.          0 - No errors
  1279.          1 - Parsing error
  1280.          2 - Insufficient Memory
  1281.          3 - DOS read error
  1282.          4 - Invalid boot sector
  1283.          5 - User ^C
  1284.          6 - Network was found
  1285.           
  1286.           
  1287.           
  1288.          -----------------
  1289.          CGA SNOW CHECKING
  1290.          -----------------
  1291.          CGA snow checking will be implemented when a successful
  1292.          test of the retrace hardware has been completed.
  1293.          Some oddball mono-graphics cards do not correctly support the
  1294.          horizontal retrace bit in CGA status port 3DAh.  The result
  1295.          is FIND hanging forever waiting for the bit to change state.
  1296.           
  1297.          The test first waits for the retrace bit to become clear,
  1298.          then waits for it to set again.  If either test fails, then
  1299.          the retrace hardware is assumed defective and snow checking
  1300.          is disabled.  It is also disabled when DesqView is active.
  1301.           
  1302.          Non-standard use of this port can cause unpredictable
  1303.          results.  If this is suspected, the user may enable or
  1304.          disable CGA snow checking from the SET SWITCHES panel of
  1305.          FINDINST.  This will override the startup tests and force the
  1306.          CGA snow testing into the mode selected by the user.
  1307.           
  1308.          The suggested method is to set CGA snow checking to OFF which
  1309.          will bypass any potential hang condition.  If no screen snow
  1310.          is encountered, leave the switch off.  Performance is
  1311.          significantly improved with snow checking turned off.
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                     Page 20
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.  
  1326.  
  1327.          IMPLEMENTATION
  1328.           
  1329.           
  1330.          --------------
  1331.          Error Messages
  1332.          --------------
  1333.          'Unable to locate or read header for..'
  1334.               o  The ZIP file is damaged or corrupted.
  1335.           
  1336.           
  1337.           
  1338.          'Logic error locating central directory for '
  1339.               o  Internal error in FIND
  1340.           
  1341.           
  1342.           
  1343.          'Insufficient memory to search this subdirectory'
  1344.               o  A subdirectory greater than 64k is being searched
  1345.                  and not enough memory is available to load it.
  1346.           
  1347.               o  /L switch has requested a scroll buffer and no EMS
  1348.                  memory is available.  Scroll buffer removes 64k of
  1349.                  DOS memory that is available for directory loads.
  1350.           
  1351.               o  FIND is trying to run in 384k or less.
  1352.           
  1353.               o  FIND is running from another program which has
  1354.                  SHELL'd out to DOS
  1355.           
  1356.           
  1357.           
  1358.          'Insufficient memory to search xxx.ZIP'
  1359.               o  Not enough free memory available to load the ZIP
  1360.                  file central directory for searching.
  1361.           
  1362.           
  1363.           
  1364.          'Invalid boot sector for drive x:'
  1365.               o  Non-standard DOS boot sector was detected.
  1366.                  Bytes per sector is zero or not contined in the
  1367.                  set of 64,128,256,512,1024,2048,4096,8192.
  1368.           
  1369.               o  Boot sector has returned Zero bytes per sector
  1370.                  Specialized RAM disks such as some AST products
  1371.                  do not utilize a standard DOS boot sector.
  1372.           
  1373.           
  1374.           
  1375.           
  1376.           
  1377.           
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.                                     Page 21
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.          IMPLEMENTATION
  1394.           
  1395.           
  1396.          -----
  1397.          Usage
  1398.          -----
  1399.           
  1400.          Valid switches are:  /G  /H  /L  /P  /S  /V  /Z
  1401.           
  1402.                   /G - Goto Match
  1403.                        The default drive and directory are changed to
  1404.                        that of the first matching file.
  1405.           
  1406.                   /H - Hidden file(s)
  1407.                        Only file attributes that match either the
  1408.                        system or hidden bits will be displayed.
  1409.                        This switch disables the /Z switch.
  1410.           
  1411.                   /L - List scroll buffer
  1412.                        The first 819 lines of output are saved in a
  1413.                        scrollable buffer.
  1414.                        This switch disables the /P switch.
  1415.                        I/O redirection cancels this switch.
  1416.           
  1417.                   /P - Pause mode
  1418.                        The program will pause when the screen is full.
  1419.           
  1420.                   /S - Single drive
  1421.                        Only a single drive will be searched.
  1422.                        If not specified, the default drive is assumed.
  1423.                        Otherwise, the first file specified by the user
  1424.                        is the only drive searched.
  1425.           
  1426.                   /V - Verbose path display
  1427.                        Every path searched will be displayed.
  1428.                        Useful to build a complete path table of the
  1429.                        specified drive(s) by searching for a non-
  1430.                        existent file.
  1431.           
  1432.                   /Z - search zip files
  1433.                        All PKZIP files will be searched for member(s)
  1434.                        matching the input argument.
  1435.                        Corrupted ZIP files will be identified with an
  1436.                        error message.  Empty ZIP files are not
  1437.                        reported.
  1438.           
  1439.           
  1440.           
  1441.           
  1442.           
  1443.           
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                     Page 22
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458.  
  1459.          IMPLEMENTATION
  1460.           
  1461.           
  1462.          ---------------------
  1463.          Command Line Examples
  1464.          ---------------------
  1465.           
  1466.              FIND file
  1467.                   Start with the default hard drive.
  1468.                   No dot defaults to all file extensions.
  1469.                   Match all occurrences of 'file????.???'
  1470.           
  1471.           
  1472.              FIND file.
  1473.                   Start with the default hard drive.
  1474.                   The dot specifies no file extension.
  1475.                   Confine match to 'file'.
  1476.           
  1477.           
  1478.              FIND *
  1479.                   Start with the default hard drive.
  1480.                   Find all files.
  1481.           
  1482.           
  1483.              FIND *.*
  1484.                   Start with the default hard drive.
  1485.                   Find all files.
  1486.           
  1487.           
  1488.              FIND *.* /H
  1489.                   Start with the default hard drive.
  1490.                   Find hidden files only.
  1491.           
  1492.           
  1493.              FIND *.* /V
  1494.                   Start with the default hard drive.
  1495.                   Display all paths as they are scanned.
  1496.           
  1497.           
  1498.              FIND *.* /H /S
  1499.                   Start with the default drive.
  1500.                   Find hidden files only.
  1501.                   Check only the default drive.
  1502.           
  1503.           
  1504.              FIND A:*.*
  1505.                   Start with the A: drive.
  1506.                   Find all files.
  1507.           
  1508.           
  1509.           
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                     Page 23
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.          IMPLEMENTATION
  1526.           
  1527.           
  1528.          ---------------------
  1529.          Command Line Examples
  1530.          ---------------------
  1531.           
  1532.              FIND G:*.* /S
  1533.                   Start with the G: drive.
  1534.                   Find all files.
  1535.                   Check only the G: drive.
  1536.           
  1537.           
  1538.              FIND *.* /H /S > PRN
  1539.                   Start with the default hard drive.
  1540.                   Find hidden files only.
  1541.                   Check only the first hard drive.
  1542.                   Redirect output to printer.
  1543.           
  1544.           
  1545.              FIND *.* /H /S > C:\Temp\Dir.Lst
  1546.                   Start with the default hard drive.
  1547.                   Find hidden files only.
  1548.                   Check only the first hard drive.
  1549.                   Redirect output to disk file on drive C:
  1550.           
  1551.           
  1552.              FIND *IBM*
  1553.                   Find any occurrence of the letters 'IBM' in
  1554.                   the file name field.  The file extent field
  1555.                   defaults to .???
  1556.           
  1557.           
  1558.              FIND *IB??IO*
  1559.                   Find any occurrence of the letters 'IB??IO' in
  1560.                   the file name field.  The file extent field
  1561.                   defaults to '.???'.
  1562.                   This example would find IBMBIO.COM.
  1563.           
  1564.           
  1565.              FIND *.*A*
  1566.                   Find any occurrence of the letter 'A' in the
  1567.                   the file extension field.  The letter can be
  1568.                   in position 1,2, or 3.   The file name field
  1569.                   defaults to '????????'.
  1570.           
  1571.           
  1572.              FIND E:Command.Com  /G
  1573.                   Find COMMAND.COM starting with the E: drive and
  1574.                   change to the drive:directory where it was found.
  1575.           
  1576.  
  1577.  
  1578.  
  1579.  
  1580.  
  1581.                                     Page 24
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.          IMPLEMENTATION
  1592.           
  1593.           
  1594.          ------------
  1595.          SUBST Drives
  1596.          ------------
  1597.          DOS allows disk subdirectories to appear as a different
  1598.          drive letter.  This is done by using the SUBST command.
  1599.           
  1600.          'SUBST E: C:\UTIL'  will cause the C:\UTIL subdirectory
  1601.          to appear as Drive E:.
  1602.           
  1603.          FIND and many DOS commands will ignore a SUBST drive.
  1604.          Under DOS 5.0, the following commands will not work, or are
  1605.          not recommended with a SUBST drive:
  1606.           
  1607.                    Assign           Diskcopy         Mirror
  1608.                    Backup           FDisk            Recover
  1609.                    Chkdsk           Format           Restore
  1610.                    Diskcomp         Label            Sys
  1611.           
  1612.           
  1613.           
  1614.          --------
  1615.          NETWORKS
  1616.          --------
  1617.          The current version FIND does not support network drives.
  1618.          It will complain and exit if a network read error is
  1619.          detected.  Support will be added in a future release.
  1620.           
  1621.           
  1622.           
  1623.          --------
  1624.          DESQVIEW
  1625.          --------
  1626.          FIND is now DesqView aware.  It will make a call to DesqView
  1627.          to determine the location of the DV Alternate Screen Buffer.
  1628.          This display buffer will be used for all screen writes.
  1629.           
  1630.          Cursor control and keyboard routines are done entirely with
  1631.          BIOS.  This enables FIND to run in the background in a small
  1632.          window.  No polling is done during scroll buffer viewing.
  1633.          This allows DesqView to swap out FIND when it is waiting for
  1634.          user input.
  1635.           
  1636.          The video display routines are coded as 'DesqView Critical'.
  1637.          The message display routine cannot be swapped out until it
  1638.          has completed its function.  Other than the color banners,
  1639.          a message display is a single line of text.
  1640.           
  1641.          FIND crashes with old versions of QEMM (v5.00).
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                                     Page 25
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.          SUPPORT
  1658.           
  1659.           
  1660.          -----------
  1661.          BUG Reports
  1662.          -----------
  1663.          Bug reports are welcomed.
  1664.           
  1665.          1)  Make/Version of DOS
  1666.          2)  Copy of AUTOEXEC.BAT and CONFIG.SYS
  1667.          3)  Names of TSRs if any, that are loaded
  1668.          4)  Redirected copy of FIND in verbose mode.
  1669.              e.g.  FIND <nonexistent.file> /V > DUMP.FIL
  1670.              This provides a list of all subdirectories.
  1671.          5)  Use SNAPSHOT to take a dump of the suspect disk.
  1672.          6)  Run CHKDSK against the failing drive.
  1673.           
  1674.          Attempt to diagnose any bugs by unloading all TSRs and
  1675.          start with as simple a system as possible.
  1676.           
  1677.           
  1678.           
  1679.          ------------
  1680.          Registration
  1681.          ------------
  1682.          Please fill out the enclosed ORDER.FRM.
  1683.           
  1684.          Bruce Gavin
  1685.          CompuServe: 70137,3244
  1686.          GEnie     : B.GAVIN
  1687.           
  1688.           
  1689.           
  1690.          ----------
  1691.          BBS System
  1692.          ----------
  1693.          Online Reference BBS:
  1694.          (719) 380-9095 (voice)
  1695.          (719) 591-0302 24 hours,
  1696.          9600 v.42bis / 8N1
  1697.           
  1698.          Programmers Online Reference Guides
  1699.          Norton Guide databases
  1700.          Available for contract programming or tele-commuting.
  1701.          Home of ALTER, ET, FRESHEN, and other fine utilities.
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.                                     Page 26
  1714.  
  1715.  
  1716.  
  1717.